home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 3 / Precision Software Applications Silver Collection Volume Three (PSM) (1993).iso / music2 / mepody.exe / MM.DOC < prev    next >
Text File  |  1991-05-21  |  38KB  |  880 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                   ________________________________
  9.                  |                                |
  10.                  |   M E L O D Y    M A S T E R   |
  11.                  |  ----------------------------  |
  12.                  |           Version 1.6          |
  13.                  |________________________________|
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                      ==========================
  20.                       U S E R ' S    G U I D E
  21.                      ==========================
  22.  
  23.  
  24.  
  25.  
  26.  
  27.                                  b y
  28.  
  29.                          Alexei A. Efros Jr.
  30.                       4195 Mount Vernon Avenue
  31.                      Riverside, CA 92506, U.S.A.
  32.  
  33.  
  34.  
  35.  
  36.  
  37.                          _______
  38.                     ____|__     |                (R)
  39.                  --|       |    |-------------------
  40.                    |   ____|__  |  Association of
  41.                    |  |       |_|  Shareware
  42.                    |__|   o   |    Professionals
  43.                  -----|   |   |---------------------
  44.                       |___|___|    MEMBER
  45.  
  46.  
  47.  
  48.                      Last Updated:  5-21-91
  49.  
  50.  
  51.  
  52.                    Copyright 1990,91 by A.A.Efros
  53.                          All Rights Reserved
  54.  
  55. MELODY MASTER                                                   Page ii
  56.  
  57.      ==================================================================
  58.         This  program  is produced by a member of the Association of
  59.         Shareware Professionals (ASP). ASP wants to make  sure  that
  60.         the  shareware principle works for you. If you are unable to
  61.         resolve a shareware-related problem with an  ASP  member  by
  62.         contacting the member directly, ASP may be able to help. The
  63.         ASP Ombudsman can help you resolve a dispute or problem with
  64.         an  ASP  member,  but does not provide technical support for
  65.         members' products. Please write to the ASP Ombudsman at  545
  66.         Grover  Road,  Muskegon  MI  49442-9427 or send a Compuserve
  67.         message via CompuServe Mail to ASP Ombudsman 70007,3536
  68.      ==================================================================
  69.  
  70.  
  71.                                -----------------
  72.                                TABLE OF CONTENTS
  73.                                -----------------
  74.  
  75.        
  76.        WARRANTY.....................................................iii
  77.      USER'S GUIDE
  78.        Introduction...................................................1
  79.        Requirements...................................................1
  80.        Getting Started................................................1
  81.        Music Notation.................................................2
  82.        Writing And Editing Music......................................2
  83.        Summary of Commands............................................3
  84.        Melody Master Functions........................................3
  85.          F1 - Help On/Off.............................................3
  86.          F2 - Save melody.............................................3
  87.          F3 - Load melody.............................................3
  88.          F4 - Play melody.............................................3
  89.          F5 - Tempos..................................................3
  90.          F7 - Output files............................................4
  91.          F8 - Play backwards..........................................5
  92.          F9 - Delete melody...........................................5
  93.          F10 - Play current page......................................5
  94.        Music Library (*.MEL)..........................................6
  95.        Configuration Utility..........................................6
  96.        Configuration File.............................................7
  97.        Description of Files...........................................8
  98.        Ideas for Future...............................................9
  99.        Acknowledgments................................................9
  100.        About Myself..................................................10
  101.      REGISTRATION INFORMATION
  102.        What do you get for registration..............................11
  103.        How to register...............................................12
  104.        Registration Form.............................................13
  105.  
  106. MELODY MASTER                                                  Page iii
  107.  
  108.       ***************** IMPORTANT WARRANTY INFORMATION ****************
  109.  
  110.  
  111.  
  112.                          Melody Master, Version 1.6
  113.  
  114.  
  115.  
  116.                *** PLEASE READ THIS INFORMATION CAREFULLY ***
  117.                    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  118.  
  119.  
  120.  
  121.  
  122.       TRIAL USE (SHAREWARE EVALUATION VERSION) WARRANTY:
  123.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  124.       The  Shareware  evaluation  (trial use) version is provided AS
  125.       IS. Alexei A. Efros MAKES NO WARRANTY OF ANY  KIND,  EXPRESSED
  126.       OR  IMPLIED,  INCLUDING  WITHOUT LIMITATION, ANY WARRANTIES OF
  127.       MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR PURPOSE.
  128.  
  129.  
  130.  
  131.  
  132.       REGISTERED VERSION ONLY WARRANTY:
  133.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  134.       Alexei A. Efros warrants the physical diskette(s) and physical
  135.       documentation provided with registered versions to be free  of
  136.       defects  in  materials  and  workmanship for a period of sixty
  137.       days from  the  date  of  registration.  If  Alexei  A.  Efros
  138.       receives notification within the warranty period of defects in
  139.       materials  or workmanship, and such notification is determined
  140.       by Alexei A. Efros to be correct, Alexei A. Efros will replace
  141.       the defective diskette(s) or documentation.
  142.  
  143.       The entire and exclusive liability and remedy  for  breach  of
  144.       this  Limited  Warranty  shall  be  limited  to replacement of
  145.       defective diskette(s) or documentation and shall  not  include
  146.       or  extend  to  any  claim  for  or right to recover any other
  147.       damages, including but not limited to, loss of  profit,  data,
  148.       or   use   of   the   software,  or  special,  incidental,  or
  149.       consequential damages or other similar claims, even if  Alexei
  150.       A.  Efros  has been specifically advised of the possibility of
  151.       such damages. In no event will Alexei A. Efros's liability for
  152.       any damages to you or any other person ever exceed  the  lower
  153.       of  suggested  list price or actual price paid for the license
  154.       to use the software, regardless of any form of the claim.
  155.  
  156.       Alexei A. Efros SPECIFICALLY DISCLAIMS ALL  OTHER  WARRANTIES,
  157.       EXPRESS  OR IMPLIED, INCLUDING BUT NOT LIMITED TO, ANY IMPLIED
  158.       WARRANTY OF MERCHANTABILITY AND/OR FITNESS  FOR  A  PARTICULAR
  159.       PURPOSE.
  160.  
  161. MELODY MASTER                                                    Page 1
  162.  
  163.  
  164.  
  165.  
  166.      INTRODUCTION
  167.  
  168.                                   
  169.         Melody Master is a music system  for  writing,  editing  and
  170.         playing  one-voice  music tunes. Melody Master uses graphics
  171.         interface which lets you see and edit  the  music  in  sheet
  172.         form. Melody Master is very useful in many ways. You can use
  173.         it  just  to listen to and play around with some of included
  174.         tunes. It  will  also  help  you  teach  yourself  (or  your
  175.         children) the beginnings of "music grammar". At last, if you
  176.         are  a programmers or a person who just likes to write Batch
  177.         Files, this is a great tool  for  making  you  own  programs
  178.         "sing".  Whatever way you are going to use it, I am sure you
  179.         will have a lot of fun!
  180.                           
  181.         Melody Master support 5  note-lengths,  5  rests,  around  7
  182.         octaves, repeats, sharps, flats, dotted notes, and 6 tempos.
  183.         The  melodies  can be saved in special *.MEL files. Melodies
  184.         can also be transferred into different forms of output files
  185.         such as BASIC programs, Pascal procedures, C functions, ANSI
  186.         Music, etc. This  package  also  contain  utility  "CONVERT"
  187.         which  let  you  convert  BASIC's play-like strings of music
  188.         into Melody Master *.MEL files.  This  makes  Melody  Master
  189.         compatible  with many other music systems. This version also
  190.         contain Configuration Utility which  let  you  set  you  own
  191.         colors, tempos, note-lengths etc.
  192.         
  193.  
  194.  
  195.      REQUIREMENTS
  196.  
  197.         Melody Master requires an IBM PC XT, PS/2, AT, or Clone with
  198.         Hercules,  CGA,  MCGA, EGA, VGA, AT&T 6300, or 3270 Graphics
  199.         adapters, and it will work with a Monochrome (Two Color)  or
  200.         Color monitor and, of course, an internal speaker.
  201.  
  202.  
  203.  
  204.      GETTING STARTED
  205.  
  206.         Type  START  at  your command prompt. You will see a menu of
  207.         activities. Choose 1 to run Melody Master or 2 to run Melody
  208.         Master on CGA or MCGA graphics cards.
  209.  
  210. MELODY MASTER                                                    Page 2
  211.  
  212.  
  213.      MUSIC NOTATION
  214.  
  215.         After  starting  the  program you will see the special graph
  216.         used to write music, with a circle  in  the  middle  of  the
  217.         center  line,  and  a  large S-like figure on the left side.
  218.         This is the position called B. If a note is  placed  on,  or
  219.         between  a  line,  it has an alphabetic letter reference, as
  220.         would a note have if we put it here on this center line. The
  221.         5 lines, from top to bottom, are referred to as F,D,B,G, and
  222.         E. So, if you put a letter on the fourth line from the  top,
  223.         it would be called a G. Notes placed in the 4 spaces between
  224.         the  lines  are  known as E, C, A, and F. Notice that if you
  225.         put a note on the top line, then the space  between  it  and
  226.         the next line, and so on, you would have the following notes
  227.         E,  F,  G,  A,  B,  C, D, E, and F. This is the way they are
  228.         referred to in normal music notation, or the  way  it  would
  229.         look if you were looking at a piece of sheet music.
  230.  
  231.  
  232.  
  233.      WRITING AND EDITING MUSIC
  234.         
  235.         To place a note, move the large circle to the line or  space
  236.         that  you  want  and  press  1  for  a  whole  note, 2 for a
  237.         half-note, 3 for a quarter-note, 4 for an eighth-note, or  5
  238.         for  a  sixteenth-note.  If  you wish to have a dotted note,
  239.         hold down the ALT key and  press  the  number  as  indicated
  240.         above (1-5). To add a rest, just hold down the SHIFT key and
  241.         press  1-5  depending  on the duration of the rest you want.
  242.         After  you  place  your  note  or  rest,  the  cursor   will
  243.         automatically  move  you to the next position so you can add
  244.         another note or rest. Maximum number of notes is 800.
  245.  
  246.         To edit your notes, just use the Right and Left  arrow  keys
  247.         to  move  the  arrows  at  the  top  to the note you want to
  248.         change. Then move the arrow on the right  with  the  Up  and
  249.         Down  arrow  keys to the right height of the note. Enter the
  250.         note that you want there. If the INSERT mode is off it  will
  251.         replace  the  note that was there. Otherwise, the whole note
  252.         text will move one position to the right and the  note  will
  253.         be  inserted.  To delete a note, put the arrow at the top of
  254.         the chart one note to the right  of  the  one  you  want  to
  255.         delete, and then press the BACKSPACE key to delete the note.
  256.         
  257.         If   you   feel   2   octaves  isn't  enough,  you  can  use
  258.         Ctrl-PgUp/Ctrl-PgDn keys. By pressing Ctrl-PgUp you will  be
  259.         8  notes higher. In this mode when you enter a note, it will
  260.         have a line at the top.  You  can  Ctrl-PgUp  again  to  get
  261.         higher  or  Ctrl-PgDn to get lower. You can see your current
  262.         octave status at the upper right hand corner.
  263.  
  264. MELODY MASTER                                                    Page 3
  265.  
  266.  
  267.      SUMMARY OF COMMANDS
  268.  
  269.  
  270.         Up, Down    - Moves the cursor up and down.
  271.         Left, Right - Moves the cursor left and right.
  272.         1,2,3,4,5    - Adds a note.
  273.         Shift-1,-2,-3,-4,-5 - Adds a rest.
  274.         Alt-1,-2,-3,-4,-5   - Adds a dotted note.
  275.           1 - Full.
  276.           2 - Half.
  277.           3 - Quarter.
  278.           4 - Eighth.
  279.           5 - Sixteenth.
  280.         Backspace - Delete the note before cursor.
  281.         Insert - Turn Insert mode On or Off.
  282.         PgUp/PgDn,Home/End - Go to the Next/Previous pages on the screen.
  283.         + - Sharp.
  284.         - - Flat.
  285.         [,] - Set repeat (reprise).
  286.         Ctrl-PgUp/Ctrl-PgDn - Change the  current  octave.
  287.         Esc - Exit current menu.
  288.         Alt-X - Quit the program.
  289.  
  290.  
  291.      MELODY MASTER FUNCTIONS
  292.  
  293.  
  294.       F1 - Turn On/Off screen help window.
  295.       ------------------------------------
  296.         You can access the Melody Master Help Utility on the  screen
  297.         while  working  with  Melody Master by pressing F1. Press F1
  298.         again to take it away.
  299.  
  300.       F2 - Save a melody.
  301.       -------------------
  302.         You can save a melody to disk in the *.MEL  file  format  by
  303.         pressing  F2.  After pressing F2 the program will ask you to
  304.         enter the name of the file. Press ENTER to save it as  shown
  305.         or   press  BACKSPACE  to  enter  another  name  WITHOUT  an
  306.         extension.
  307.  
  308.       F3 - Load a melody.
  309.       -------------------
  310.         This command opens a window of files you can load.  Use  Up,
  311.         Down,  PgUp  and  PgDn  keys  to  select file and than press
  312.         ENTER.
  313.  
  314.       F4 - Play a melody.
  315.       -------------------
  316.         This command plays the current melody. Press ESC to stop.
  317.  
  318.       F5 - Tempo.
  319.       -----------
  320.         Select one of 6 tempos. Allegro  is  the  Default.  Use  the
  321.         configuration utility to make your own tempos.
  322.  
  323. MELODY MASTER                                                    Page 4
  324.  
  325.       F7 - Output files.
  326.       ------------------
  327.         If  you  are not really good in this computer stuff, you may
  328.         just skip this section. This operation is used  to  generate
  329.         an output ASCII file. This file may contain commands or data
  330.         for a specific application.
  331.         After  pressing  F7,  the  computer will ask you the type of
  332.         output file you want to create (Pascal 1,  Pascal  2,  C,  C
  333.         array, Turbo C, BASIC, data file, SPKR.SYS, ANSI, Standard).
  334.         Melody  Master  will  write  the  file on disk in the chosen
  335.         type. The file will have the name of internal file plus  the
  336.         right  extension: .pas, .bas, .c, .spk, .dat, .ans, or .asc.
  337.         In the case of data files, the procedure  is  a  little  bit
  338.         different (see Data File).
  339.         Notes for different types of output files:
  340.  
  341.         PASCAL 1.......
  342.         Compilers which have functions: SOUND, DELAY and NOSOUND can
  343.         be  used  (for  example  Turbo  Pascal).  Output  file  is a
  344.         procedure which can be included into your  program  using  a
  345.         screen editor or directive {$INCLUDE filename}.
  346.  
  347.         PASCAL 2....... (New!)
  348.         Output  is  a  text  file containing a constant 2-D array of
  349.         frequencies and durations. This file should be  included  in
  350.         "CONST"  section  of  your  program  (you  will have to move
  351.         statement "MAX = {n}" and place it BEFORE  the  array).  Use
  352.         PlayArray  procedure  (file  PLARRAY.PAS) to play the music.
  353.         This method is probably the most compact one in terms of the
  354.         size of generated code.
  355.  
  356.         C..............
  357.         Output file is a C function which can be  called  from  your
  358.         program.  Function  tone()  (file TONE.C) is used for making
  359.         sounds (you may have to make some adjustments in tone()  for
  360.         the speed of your PC)
  361.  
  362.         C array........  (New!)
  363.         Output  is  a  text  file  containing  a global 2-D array of
  364.         frequencies and durations. Use  playarray()  function  (file
  365.         PLARRAY.C)  to  play  the music. This method is probably the
  366.         most compact one in terms of the size of generated code.
  367.  
  368.         Turbo C........
  369.         Output file is Turbo C function which use  sound(),  delay()
  370.         and nosound() functions for making sounds.
  371.  
  372.         BASIC.......... (Renew!)
  373.         The  output  is  ASCII  BASIC file which contain a number of
  374.         PLAY functions (with  line  numbers!).  You  might  want  to
  375.         change tempo and some other initial sittings.
  376.  
  377. MELODY MASTER                                                    Page 5
  378.  
  379.         Data File......
  380.         If  the  type  of  the output file is Data File, the program
  381.         will ask if you want to create a "new file" of to extend  an
  382.         existed  one. A Melody Master Data file is a text file. Each
  383.         of its lines is one melody. This is the line format:
  384.            [MelodyName] [frequency of 1st note] [duration of 1st note]
  385.            [frequency of 2nd note] [duration of 2nd note] ... [CR]
  386.            [MelodyName] [frequency of 1st note] [duration of 1st note]
  387.            [frequency of 2nd note] [duration of 2nd note] ... [CR]
  388.            ...
  389.         If you work in Pascal or C,  you  can  use  already  written
  390.         procedure  PLAY  which  work  with  Melody Master data files
  391.         (PLAY.PAS or PLAY.C). You can also use command  PLAY.EXE  to
  392.         do the same thing from batch files or other programs.
  393.  
  394.         SPKR.SYS....... (New!)
  395.         The  output is an ASCII file which can be used with SPKR.SYS
  396.         software. SPRK.SYS is an installable device  which  let  you
  397.         play  music  in  the background (while program is working on
  398.         something else). The  author,  Mr.  C.  J.  Dunford,  kindly
  399.         allowed  me to include his program into my software package.
  400.         Refer to SPKR.DOC for more information. SPKR.SYS can play no
  401.         more than 128 note per file, so if your melody is more  than
  402.         128  notes  long,  Melody  Master will split it into several
  403.         files with extensions .spk, .sp2, sp3, sp4 etc. You can  use
  404.         SPKR.SYS in any application or language (even FORTRAN!).
  405.  
  406.         ANSI........... (New!)
  407.         This  option  will  give you an output in ANSI Music format.
  408.         The format is as shown:
  409.               ESC[M ...music codes string... ^N
  410.         If you are a SYSOP you can make "the first singing BBS!".
  411.         
  412.         STANDARD....... (New!)
  413.         Using this option you get a file  of  BASIC's  PLAY  command
  414.         strings. This makes Melody Master compatible with many other
  415.         music systems such as VMUSIC. (Use CONVERT utility to do the
  416.         opposite operation).
  417.         
  418.         CUSTOMIZING
  419.         For registered users only!  I  might  customize  the  output
  420.         files  for  a  small additional payment or even for free, if
  421.         your idea sounds interesting.
  422.  
  423.  
  424.       F8 - Play a melody backwards.
  425.       ------------------------------
  426.         This command plays the entire melody backwards (just for fun!).
  427.  
  428.       F9 - Delete a melody from the memory.
  429.       -------------------------------------
  430.         This command deletes everything from memory so you can start
  431.         to write a new melody.
  432.  
  433.       F10 - Play current page.
  434.       ------------------------
  435.         The command plays the current page of music on the screen.
  436. MELODY MASTER                                                    Page 6
  437.  
  438.  
  439.      MUSIC LIBRARY (*.MEL)
  440.  
  441.         Most the music in the library I entered without using  music
  442.         scores but by ear. So there might be some difference between
  443.         my  interpretation  and  the real thing, sorry. Feel free to
  444.         include these melodies into your commercial programs as  long
  445.         as you are a registered user.
  446.  
  447.         If you wrote or entered a nice music piece you want to share
  448.         with  others  you can include it in later versions of Melody
  449.         Master by contacting me. I will really appreciate it!
  450.  
  451.  
  452.  
  453.      CONFIGURATION UTILITY
  454.  
  455.         Melody   Master  1.6   has  its  own  configuration  utility
  456.         (MMCONFIG.EXE) and configuration  file  (MMCONFIG.PAR).  Run
  457.         MMCONFIG.EXE  from the DOS prompt or from START.BAT. If your
  458.         copy of Melody Master doesn't have this file or somehow  you
  459.         can't  run  it  on  your  PC,  you  can edit MMCONFIG.PAR by
  460.         yourself, see CONFIGURATION FILE.
  461.         After  you  have started the Utility a main menu will appear
  462.         on the screen. Use  the  Up/Down  arrow  keys  to  highlight
  463.         different options. Use the ENTER key to choose an option.
  464.  
  465.         Select  "Set  Own  Colors"  to  choose screen foreground and
  466.         background colors for Melody Master. If the colors you  have
  467.         chosen  are  out-of-range  of your monitor, you will not get
  468.         any notification but Melody Master will use  0  (Black)  for
  469.         the foreground and 1 (Blue) for the background.
  470.  
  471.         Select  "Set Own Tempos" to add new tempos or change the old
  472.         ones. In the Tempo Window you will see name of a  particular
  473.         tempo,  equal sign and a number. The number is a ratio which
  474.         is multiplied by the note-length to get the  current  tempo.
  475.         To  change  a  tempo,  press  ENTER  on  the one you want to
  476.         change. To add a tempo, press ENTER on  the  next  available
  477.         "Not Used". Maximum of 16 tempos is allowed.
  478.  
  479.         Select  "Set  Own  Lengths"  to modify the note-lengths. The
  480.         lengths are given in milliseconds. Press ENTER to  change  a
  481.         note-length.
  482.  
  483.         Select   "Help  On/Off"  to  choose  between  immediate  and
  484.         optional help. If you  set  the  immediate  help,  the  help
  485.         window  will  appear  when  you  start  Melody  Master while
  486.         optional help will activate the help window  only  when  you
  487.         press  F1.  The  default is immediate. When you have learned
  488.         the basic Melody Master commands you might want to set it to
  489.         optional (on slow PCs, help takes  a  noticeable  amount  of
  490.         time).
  491.  
  492.         Select "Save & Exit" to quit the program and save changes in
  493.         MMCONFIG.PAR.  If  this  file  didn't exist the program will
  494.         create it.
  495. MELODY MASTER                                                    Page 7
  496.  
  497.  
  498.      CONFIGURATION FILE
  499.  
  500.         Configuration file is  an  ASCII  file  called  MMCONFIG.PAR
  501.         which  contain information about settings for Melody Master.
  502.         There  is  another  configuration  file  STANDARD.PAR  which
  503.         contain  the initial sittings. If you have accidentally done
  504.         something wrong, use RENEW.BAT to copy STANDARD.PAR in place
  505.         of MMCONFIG.PAR.
  506.         The following information is for those of you  who  couldn't
  507.         get the Configuration Utility to work or just don't have it.
  508.         MMCONFIG.PAR is an ASCII  file.  This  means  you  can  edit
  509.         it  using any word processor which can work with ASCII files
  510.         (EDLIN, for example). The  structure  of  the config file is
  511.         as follows:
  512.      ------------- MMCONFIG.PAR ----------------------
  513.      [Foreground Color number] [Background Color number]
  514.      [Help on/off code]
  515.      [Full-length] [half] [forth] [eighth] [sixteenth]
  516.      [Number of Tempos]
  517.      [Tempo Name]
  518.      [Tempo Ratio]
  519.      [Temp Name]
  520.      [Temp Ratio]
  521.      ...
  522.      -------------------------------------------------
  523.      Foreground and background colors are numbers as followed:
  524.            Black - 0 ... White - 15
  525.      Immediate  help is corresponded with number 1, optional help
  526.      with number 2.
  527.  
  528. MELODY MASTER                                                    Page 8
  529.  
  530.  
  531.  
  532.                       DESCRIPTION OF FILES
  533.  
  534.  
  535.      START.BAT     - Menu batch file. Run This file first!
  536.      MM.EXE        - Program Melody Master.
  537.      MMCGA.EXE     - Program Melody Master (version for CGA or MCGA).
  538.      MM2MEL.EXE    - This utility converts *.MM files from v1.5 into
  539.                      new *.MEL files.
  540.      CONVERT.EXE   - This utility converts BASIC's  PLAY-like  strings
  541.                      into *.MEL files.
  542.      MMCONFIG.EXE  - Configuration Utility for Melody Master.
  543.      MMCONFIG.PAR  - Configuration file for Melody Master.
  544.      STANDARD.PAR  - Configuration file of standard sittings.
  545.      RENEW.BAT     - This  file  makes  standard  configuration  by
  546.                      copying STANDARD.PAR  into  MMCONFIG.PAR.  The
  547.                      old information in MMCONFIG.PAR is deleted!
  548.      TONE.C        - Function tone() for making sound in C.
  549.      DELAY.C       - This is a main body of C function  own_delay()
  550.                      for playing background music.
  551.      PLAY.C        - C function PLAY for use  with   Melody  Master
  552.                      data files.
  553.      PLARRAY.C     - C function playarray() for use with "C  array"
  554.                      output file.
  555.      PLAY.PAS      - Pascal procedure  PLAY  for  use  with  Melody
  556.                      Master data files.
  557.      PLARRAY.PAS   - Pascal  procedure  PlayArray  for   use   with
  558.                      "Pascal 2" output file.
  559.      PLAY.EXE      - Batch file command for use with Melody  Master
  560.                      data files.
  561.      MM.DOC        - This file.
  562.      LICENSE.DOC   - Program License.
  563.      SHR-WARE.DOC  - About  Shareware  and  ASP.  Used  here   with
  564.                      permission from Falk Data Systems.
  565.      SYSOP.DOC     - Information for BBS SYSOPs
  566.      VENDOR.DOC    - Information for Shareware Distributors.
  567.      NEWSTUFF.DOC  - All upgrades since v1.5
  568.      *.MEL         - Music files.
  569.      *.BGI         - Turbo PASCAL 5.5 graphic drivers.
  570.      TRIP.CHR      - Turbo PASCAL 5.5 Triplex font.
  571.      PAGING.EXE    - This program shows a text file on the  screen.
  572.      ASK.COM       - Extended batch file command. Read key from the
  573.                      keyboard.
  574.      SPKR.SYS      - Installable  device  for  playing  background
  575.                      music.  Used  here  with  permission  from  the
  576.                      author.
  577.      SPKR.DOC      - Documentation for SPKR.SYS.
  578.      SONGS.EXE     - Each time the program plays different melody.
  579.      SONGS.SNG     - Data for SONGS.EXE.
  580.      ORDER.FRM     - Shareware order form. PRINT IT OUT!
  581.      PACKING.LST   - List of all files.
  582.  
  583. MELODY MASTER                                                    Page 9
  584.  
  585.  
  586.      IDEAS FOR FUTURE
  587.  
  588.         The  whole future of Melody Master is depending on you! Your
  589.         support and comments  are  my  main  sources!  Shall  Melody
  590.         Master   be   a  programmer's  tool,  educational  game,  or
  591.         something else? It's up to YOU! Here are some ideas  I  came
  592.         up with. Let me know if they are good.
  593.  
  594.         o  Add  some  more  features of the real editor: mark, copy,
  595.            paste, etc.
  596.  
  597.         o  Allow placing of sharps and flats at  the  beginning. Global
  598.            change of octave. Maybe even global change of key!
  599.  
  600.         o  Global and local legato / staccato.
  601.  
  602.         o  More  music  files.  I  depend  on you folks! My music is
  603.            mostly classics - nobody likes it anymore! (very pity!)
  604.  
  605.         o  Print the sheet music on printer. This one is also  fully
  606.            depends  on  you!  I can't yet afford to buy the printing
  607.            software yet.
  608.  
  609.         o  THIS ONE IS FOR YOU TO FEEL OUT!!!
  610.  
  611.  
  612.  
  613.      ACKNOWLEDGMENTS
  614.  
  615.         I am very  grateful  to  Leon  Kamenkovich,  a  professional
  616.         musician for consultations and remarks. Also I would like to
  617.         thank Michael Levin who helped me with drawings.
  618.         There are also some people I would like to thank for helping
  619.         me  with business of Shareware. I am very grateful to Nelson
  620.         Ford  for  writing  "Programmer's  Guide",  great  book  for
  621.         marketing  Shareware  (one can get a copy of it on disk from
  622.         Public (software) Library). Thanks also goes to Bob Falk who
  623.         kindly let me (as well as other ASP members)  use  his  text
  624.         files such as SHR-WARE.DOC.
  625.         Special thanks to those of you helped (or will help)  me  by
  626.         supporting  the  program  and giving comments and new ideas!
  627.         THANK YOU ALL VERY MUCH!
  628. MELODY MASTER                                                   Page 10
  629.  
  630.  
  631.      ABOUT MYSELF
  632.  
  633.         I  was  born in Leningrad, U.S.S.R. I started my career as a
  634.         programmer at the age of 7 when my dad taught me how to  use
  635.         Soviet  programming  calculator B3-34. It did only about 1/2
  636.         operation a second (if it was  in  a  good  mood!).  Then  I
  637.         switched  to  the  first Soviet PC called BK-0010. It was on
  638.         the same level with Commodore but used very old  and  stupid
  639.         language  called  FOCAL. I have written a number of programs
  640.         in FOCAL including LOGO interpreter.
  641.         In 1989 my whole life has changed because I  and  my  family
  642.         moved  to the U.S. Now I am in high school and I am going to
  643.         be a computer scientist.
  644.         Melody Master was one of my first and yet largest program on
  645.         this type of computer. I started in May  of  1989.  The  job
  646.         didn't  go fast because I worked only on weekends. The first
  647.         release (v1.5) was in August of 1990.
  648.         I like three things:  eating  ice  cream,  programming,  and
  649.         playing the piano.
  650.  
  651.        +============================================================+
  652.        |Again, Melody Master is NOT a  Public  Domain  software  but|
  653.        |Shareware and in require registration.                      |
  654.        +============================================================+
  655.  
  656.         If you have any questions, comments, or job offers feel free
  657.         to contact me:
  658.  
  659.  
  660.                          Alexei A. Efros Jr.
  661.                         4195  Mt. Vernon Ave.
  662.                          Riverside, CA 92507
  663.                  (714) 276-1501 (Ask for Alexei Jr.)
  664.  
  665.         (Technical support is only for registered users!)
  666.  
  667. MELODY MASTER                                                   Page 11
  668.  
  669.              =================================================
  670.               R E G I S T R A T I O N   I N F O R M A T I O N
  671.              =================================================
  672.  
  673.  
  674.  
  675.             Support Shareware by registering today! Thank you!
  676.  
  677.  
  678.  
  679.     If   you   don't   know   what  Shareware is,  please  refer  to
  680.     SHR-WARE.DOC. If you can't reach me at the address  given  above
  681.     please  try  to  contact  ASP  to  get  my new address (refer to
  682.     SHR-WARE.DOC). Thank you!
  683.  
  684.  
  685.     --------------------------------
  686.     WHAT DO YOU GET FOR REGISTRATION
  687.     --------------------------------
  688.  
  689.     For "REGISTRATION ONLY" you will get the following:
  690.  
  691.     Technical Support
  692.     ~~~~~~~~~~~~~~~~~
  693.     1  year of phone technical support is provided to all registered
  694.     users. Unfortunately I cannot specify the exact time  for  calls
  695.     so an option of mail technical support is also provided. If this
  696.     business  gives  me  good  profits  I  might  get  an account on
  697.     CompuServe to receive your questions.
  698.  
  699.  
  700.     Notification of Future Upgrades
  701.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  702.     All registered  users  will  first  receive  notification  about
  703.     upgrades  of Melody Master. Discounts might be provided for this
  704.     and my other programs.
  705.  
  706.  
  707.     Right to use Melody Master Output Files
  708.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  709.     Registered users are permitted to use Melody Master Output Files
  710.     and  some  other  playing utilities (PLAY.*, PLARRAY.*) in their
  711.     personal commercial software.
  712.  
  713.  
  714.     Proof of Registration
  715.     ~~~~~~~~~~~~~~~~~~~~~
  716.     All  registered  users  will  receive   a   written   proof   of
  717.     registration from the author.
  718.  
  719.  
  720.     Good Feeling
  721.     ~~~~~~~~~~~~
  722.     Best  of  all,  you  will  get a good feeling for supporting the
  723.     "try-before-you-buy" concept! Also  you  will  sleep  better  at
  724.     night  knowing  that "Big Man from Copyright office" won't scare
  725.     you. :->
  726. MELODY MASTER                                                   Page 12
  727.     
  728.  
  729.     For "REGISTRATION AND DISK" you get all above PLUS the following:
  730.  
  731.     Latest Version of the Program on Disk
  732.     ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  733.     Floppy disk with the latest registered version of Melody  Master
  734.     will  be  provided  with  "REGISTRATION  AND  DISK"  option. The
  735.     registered  version  will  exclude  the  Registration   Reminder
  736.     Screen. It will also contain the latest and the best melodies.
  737.  
  738.  
  739.     Printed Manual
  740.     ~~~~~~~~~~~~~~
  741.     You will also get a printed manual with the program  disk.  Note
  742.     that my English is becoming better with every new version of the
  743.     program.  So  there  is  a good chance that someday I will write
  744.     understandable documentation! :->
  745.  
  746.  
  747.     For "MELODY MASTER SOURCE CODE" you get:
  748.  
  749.     Program Source Code
  750.     ~~~~~~~~~~~~~~~~~~~
  751.     Yes! With this registration option you will get more than 70K of
  752.     source code in Turbo PASCAL. To be honest with you, most  of  it
  753.     is  a  good "spaghetti meal"! I myself lost a hope to understand
  754.     some of its "dark corners" (That's what you get for not  writing
  755.     comments)!   However,   the  procedures  for  output  files  are
  756.     structured and more understandable so it's still a good deal!
  757.  
  758.  
  759.  
  760.     ----------------
  761.     HOW TO REGISTER:
  762.     ----------------
  763.  
  764.     Registration is easy! Simply print a copy of the following Order
  765.     Form, fill it out, and send it in along with your payment to:
  766.  
  767.     Alexei A. Efros Jr.               Phone: 714-276-2501
  768.     4195 Mt. Vernon Ave.                     (Ask for Alexei JR.)
  769.     Riverside, CA 92507
  770.     U.S.A.
  771.  
  772.     You can also order from Public (software) Library with your  MC,
  773.     Visa,  AmEx  or  Discover  card  by  calling  1-800-2424-PsL, or
  774.     713-524-6394 or by FAX  to  713-524-6398  or  by  CompuServe  to
  775.     71355,470  or  by  mail  to  PsL,  P.O.Box 35705, Houston, Texas
  776.     77235-5705. These numbers are for ordering only. For information
  777.     about dealer pricing, volume discounts, site licensing, shipping
  778.     of product, returns, latest version number  or  other  technical
  779.     information,  contact  the  author.  If you order thought Public
  780.     (software) Library please add $5 for service.
  781.     NOTE: Please allow up to 3 weeks for delivery.
  782.                                    
  783.                          MELODY MASTER VERSION 1.6
  784.                                 ORDER FORM
  785.  
  786. Please send:
  787.  
  788.  Melody Master Registration ....................@ $10.00 ea _____
  789.   includes:
  790.    1. Proof of registration.
  791.    2. Notification about new versions of the program.
  792.    3. 1 year technical support.
  793.    4. Permission for using Output Files.
  794.  
  795.  Melody Master Registration and Disk ...........@ $20.00 ea _____
  796.   ALSO includes:
  797.    5. Latest version of Melody Master on disk.
  798.    6. Printed manual.
  799.    7. Latest melodies.
  800.  
  801.  Melody Master Source Code .....................@ $50.00 ea _____
  802.  includes:
  803.    8. Melody Master Source Code in Turbo Pascal.
  804.  
  805.                                                   Subtotal ______
  806.                     Shipping & Handling..........add $4 ea ______
  807.                                Overseas..........add $7 ea ______
  808.                    Ordering thought PsL..........add $5    ______
  809.  
  810.                                                 TOTAL ___________
  811.  
  812.  Payment by:      ( ) Check   ( ) Cash
  813.                   Check or Cash drawn on a U.S.A. bank in U.S. funds.
  814.  Disk size:       ( ) 5.25"   ( ) 3.5"
  815.  
  816.        Name: ____________________________________________________
  817.  
  818.     Company: ____________________________________________________
  819.  
  820.       Title: ____________________________________________________
  821.  
  822.     Address: ____________________________________________________
  823.  
  824.        City: ________________________ State/Province:____________
  825.  
  826.     Country: ________________________ Zip/Postcode:______________
  827.  
  828.       Phone: ____________________________________________________
  829.  
  830.        Date: ________________ Signature: ________________________
  831.  
  832.   What type of computer do you use:
  833.         ( ) PC/XT (8086)       ( ) 386 ____MHz        ( ) Other
  834.         ( ) AT    (286)        ( ) 486 ____MHz      _______________
  835.  
  836.   What Graphic Adapter do you use:
  837.         ( ) CGA/MCGA      ( ) EGA      ( ) Hercules    ( ) VGA
  838.         ( ) Super VGA     ( ) Other _______________
  839.  
  840.   Do you have color monitor? (Y/N) ___
  841.   Do you have MIDI (Y/N) ___
  842.  
  843.   What is your music knowledge: __________________________________
  844.  
  845.   What is your computer knowledge: _______________________________
  846.  
  847.   Where did you get the copy of Melody Master?
  848.  
  849.       ( ) BBS   (Name: ____________________ Phone: _____________)
  850.  
  851.       ( ) Shareware Distributor (Name: _________________________)
  852.  
  853.       ( ) Other _________________________________________________
  854.  
  855.   What do you like about Melody Master?
  856.  
  857.       ( ) Graphic interface            ( ) On-Line Help
  858.       ( ) Output Files                 ( ) Good melodies
  859.       ( ) Good manual (HA-HA!)         ( ) Easy-to-use
  860.       ( ) Other _________________________________________________
  861.  
  862.   Comments, suggestions, criticisms, requests (as much as you want!):
  863.  
  864.    ______________________________________________________________
  865.  
  866.    ______________________________________________________________
  867.  
  868.    ______________________________________________________________
  869.  
  870.    ______________________________________________________________
  871.  
  872.    ______________________________________________________________
  873.  
  874.    ______________________________________________________________
  875.  
  876.    ______________________________________________________________
  877.  
  878.    ______________________________________________________________
  879.          Above information is a subject to change without notice.
  880.